home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr09 / ws4paf21.zip / WS4PAF21.DOC < prev    next >
Text File  |  1993-06-02  |  15KB  |  374 lines
  1.               ╔═════════════════════════════════════╗
  2.               ║                                     ║
  3.               ║         Worksheet Generator         ║
  4.               ║                for                  ║
  5.               ║       Personal Ancestral File       ║
  6.               ║               (PAF)                 ║
  7.               ║                 by                  ║
  8.               ║         Frank E. Hutchison          ║
  9.               ║                                     ║
  10.               ╚═════════════════════════════════════╝
  11.  
  12. Worksheet Generator for Personal Ancestral File (PAF) is a program
  13. that will create a worksheet for an individual which contains the
  14. information found in a PAF database that relates to that person. 
  15. The person's parents, spouse(s), children, their spouse(s), and
  16. grandchild are also shown on the screen, printer, or a user-
  17. designated file.  Worksheet Generator works only with PAF databases
  18. containing INDIV2.DAT, MARR2.DAT, NAME2.DAT and NOTES2.DAT.  Other
  19. files of PAF are not used nor are GEDCOM files.
  20.  
  21. To use WS4PAF, you must know:
  22.  
  23.      (1)  Where the PAF database is located (C:\PAF\DATA, B:, etc.)
  24.  
  25.      (2)  The individual's Record Identification Number (RIN) or
  26.           information about the individual to search on just as
  27.           PAF does to locate individuals.
  28.  
  29.      (3)  Where and what to name the output file, if selected.
  30.  
  31. In addition, menu selection is made by selecting the menu number,
  32. or use of the up and down arrow keys.
  33.  
  34. There are four menus in WS4PAF.  The first menu asks
  35.  
  36.                   Where is the PAF database located?
  37.  
  38.                   1.  A:
  39.                   2.  B:
  40.                   3.  C:\PAF\DATA
  41.                   4.  Other
  42.                   5.  Return to System
  43.  
  44. The first three choices will encompass probably 90% of the
  45. locations of PAF databases.  If your's is not one of the first
  46. three choices, then select option 4.  Just below the above menu
  47. will be displayed:
  48.  
  49.                   Location of PAF database: 
  50.  
  51. You can type in the path to the database.  The WS4PAF does NOT
  52. check this information.  If it is wrong, then you will get an error
  53. and will need to restart the program.
  54.  
  55. The second menu asks:
  56.  
  57.                Output to the printer will be:
  58.  
  59.                1.  With compressed print
  60.                2.  Without compressed print
  61.  
  62. This choice will determine of compressed print (17 characters per
  63. inch) is used with printed output.  The option without compressed
  64. print will cause the place for each event to be printed on a
  65. separate line.
  66.  
  67. The third menu asks:
  68.  
  69.                   Identify Starting Individual
  70.  
  71.                   1.  Know RIN
  72.                   2.  Do not know RIN
  73.                   3.  Help Screen
  74.                   4.  Change directory
  75.                   0.  Return to System
  76.  
  77. Option 1 will ask: Which RIN?  Type in the RIN.  The RIN you have
  78. entered will be checked, the individual information displayed, and
  79. you will be asked if it's the correct individual.  If it is the
  80. correct individual, then WS4PAF will proceed to generate the
  81. worksheet.
  82.  
  83. Option 2 allows you to find an individual's RIN by entering
  84. information about the individual and then searching the PAF
  85. database for that individual.  This is similar to the way PAF finds
  86. an individual when the "Match names and positions during individual
  87. search" option in CONFIG is choosen.  Option 2 will display the
  88. following
  89.  
  90.                               Individual Search
  91. =================================================================
  92. Surname:                   Given1:                   Sex:
  93. Given2:                    Given3:                   Title:
  94. -----------------------------------------------------------------
  95. Birth date:
  96. Place1:                            Place2:
  97. Place3:                            Place4:
  98. -----------------------------------------------------------------
  99. Christening date:
  100. Place1:                            Place2:
  101. Place3:                            Place4:
  102. -----------------------------------------------------------------
  103. Death date:
  104. Place1:                            Place2:
  105. Place3:                            Place4:
  106. -----------------------------------------------------------------
  107. Burial date:
  108. Place1:                            Place2:
  109. Place3:                            Place4:
  110. =================================================================
  111.  
  112. You can enter as much or as little information you wish.  You can
  113. move around the screen using the Enter, Tab, Shift-Tab, Up and Down
  114. Arrows and end the inputting by pushing the F1 key to start the
  115. search or the F2 key to quit.  This is the same as PAF.  Names are
  116. checked when you enter them to insure they are in the NAME2.DAT
  117. file.
  118.  
  119. Option #3 is a summary of this information.
  120.  
  121. Option #4 ends the program and returns you to the system prompt.
  122.  
  123. The fourth menu asks:
  124.  
  125.           What is the location of the output?
  126.  
  127.                1.  Screen
  128.                2.  Printer
  129.                3.  File
  130.                4.  Cancel
  131.  
  132. Option #1 results in the worksheet being displayed on the screen. 
  133. This is best used to see the output BEFORE printing or creating a
  134. file.
  135.  
  136. Option #2 results in the worksheet being sent to the printer.  The
  137. printer is assumed to be Epson compatible, however, the only
  138. special control sent to the printer is the command for compressed
  139. print (17 Characters Per Inch (CPI)).
  140.  
  141. Option #3 will result in the creation of a file containing the
  142. worksheet.  If you select this option, you will be asked:
  143.  
  144.                Location and name of file:
  145.  
  146. WS4PAF does check what it is given for a file name and path.  If
  147. the file already exists, you will be asked if you want to over
  148. write it.  If you don not enter a file name (just hit the Return or
  149. Enter key, without entering any name), then the file will be named
  150. PRINT.DAT and placed in the same directory or subdirectory as
  151. WS4PAF.
  152.  
  153. WS4PAF will finally ask
  154.  
  155.               Print Notes? (Y/N) <Y> 
  156.  
  157. If you don't want the notes printed, answer "N" for no, otherwise,
  158. the default answer is yes.
  159.  
  160. Now WS4PAF creates the worksheet.  An sample is show below and an
  161. actual sample is included as PRINT.DAT in the ZIP-file.  Due to the
  162. limit of 80 columns for a computer screen, some of the lines have
  163. been split.  Where the line was split is indicated by the double
  164. asterisks (**).  When the printer output (Option #2) is selected,
  165. everything from Christening: to the end of the worksheet is printed
  166. in compressed print (17 CPI) as well as the Birth line.  Output to
  167. the screen (Option #1) will wrap the output as necessary.
  168.  
  169. Sometimes, a line of characters will be too long for your printer
  170. to print on one line.  You will notice this when the line is
  171. partially moved to the next line.
  172.  
  173. TROUBLESHOOTING
  174.  
  175. WS4PAF does not have a lot of error trapping built into itself.  If
  176. you have a problem with WS4PAF, please try the following
  177. suggestions to solve the problem:
  178. 1.   Is the printer on?  Does it have paper?  (WS4PAF should tell
  179.      you if these are problems.)
  180. 2.   Is the directory identified for the PAF database correct?
  181. 3.   If you are sending a file to disk, is there enough disk space?
  182.  
  183. If none of the above solves your problem, then please contact the
  184. author (address on the last page) with the following information:
  185. 1.   Where in the program the problem occurs.
  186. 2.   A copy of any print out available.
  187. 3.   A copy of the screen dump (press the Print Screen button with
  188.      the printer on).
  189. 4.   A description of your computer (PC, XT, AT, 386, 486, etc.),
  190.      amount of memory, monitor, and video, as well as, your printer
  191.      type.                         Worksheet for John HUTCHISON
  192. RIN: 267           Sex: M                              ID: 4G91-L8 
  193. Birth: 16 Nov 1840 at ____________, Trigg, KY, ____________
  194.  
  195. Father: William T. HUTCHISON
  196.  
  197. Mother: Mary Clay DAWSON
  198.  
  199. Christening: ___ ____ _____ at _______, _______, ________, ________
  200. Death: 12 Jul 1913 at Ochelata, Washington, OK, ____________
  201. Burial: ___ ____ _____ at _______, ________, ________, _________
  202.  
  203. Spouse: Sarah Ellen WALLACE (**) 
  204.  marriage date: 5 Oct 1868 at Independence, Jackson, Mo, _________
  205.  Child: (M) William HUTCHISON ___ ____ 1870 Independence, (**)
  206.    Jackson,  Mo,_________
  207.   No marriage
  208.  Child: (M) Warner HUTCHISON 11 Nov 1872 Independence, (**)
  209.    Jackson, Mo, __________
  210.   wife: Gertrude PECK  (**)
  211.    marriage date: 30 Jul 1900 at __________, __________, (**)
  212.     __________, __________
  213.    grandchild: (**)
  214.    (M) John E. HUTCHISON  27 Nov 1901 at Stow, __________, (**)
  215.     OH, ____________
  216.    grandchild: (**)
  217.    (M) Wallace I. HUTCHISON  24 Jan 1905 at Chicago, Cook, (**)
  218.     IL, ____________
  219.  Child: (F) Marietta HUTCHISON 20 Oct 1873 Independence, (**)
  220.     Jackson, Mo, _________
  221.   husband: Charles FISHER  (**)
  222.   marriage date: ___ ____ _____ at __________, __________, (**)
  223.      _________, _________
  224.  
  225. Spouse: Molly ERBY (**)
  226.  marriage date: ___ ____ _____ at _________, _________, (**)
  227.    _________, __________
  228.  Child: (**)
  229.  (M) Ralph HUTCHISON ___ ____ _____ at _________, (**)
  230.    _________, ________, ________
  231.   No marriage
  232.  
  233. NOTES:
  234.  
  235. !Descendent chart by Lawrence Hutchison notes U. S. Indian
  236. Marshall, Pahuska, Oklahoma Territory, 1896-1901 WS4PAF only READS and does not write to PAF files.  There should be
  237. no disruption of your PAF data files by WS4PAF.  However, it is
  238. good practice to ALWAYS have a back-up of your data whenever you
  239. use a new program and especially after you have added to or changed
  240. any information in your database.
  241.  
  242. Version 1.1 differences
  243. Thanks to Don Umberger, who:
  244.     -     Pointed out a bug in the search routine which has been
  245.           corrected.
  246.     -     Suggested the RIN be added to the worksheet.
  247.     -     Noted that the search option was similiar to PAF ONLY if
  248.           the "Match names and positions during individual search"
  249.           CONFIG option was selected.
  250.     -     Suggested the option to print or not to print notes.
  251. Version 1.2 differences
  252. Thanks again to Don Umberger, who:
  253.     -     Pointed out a bug with the print to file which is
  254.           corrected.
  255.     -     Suggested that the user be notified if the print to file
  256.           filename already existed.
  257. Version 1.3 differences
  258. Thanks to Diane Hicks and Ruth Czigan, who:
  259.     -     Pointed out a bug that introduced a form feed where a
  260.           line feed was suppose to be.
  261. Version 1.4 differences
  262. Thanks to Ruth Czigan, who:
  263.     -     Pointed out that only the first marriage of the children
  264.           was shown in earlier versions.  All marriages are now
  265.           shown.
  266. Version 2.0 differences
  267.     -     This is almost an entire rewrite of the program.  In
  268.           particular, this version will:
  269.           o  Work with monochrome monitors (earlier version
  270.           didn't).
  271.           o  Allows the user to choose between using compressed
  272.           print or not.  This was requested by those who have a
  273.           hard time seeing the small print of 17 CPI.  If the
  274.           output is without compressed print, then the place of
  275.           each event is printed on a separate line.
  276.           o  Page breaks have been inserted in printer output.  At
  277.           least six lines will be placed at the top and bottom of
  278.           each page.
  279. Version 2.1 differences
  280. Thanks to Dewey Raymond Watkins, who:
  281.     -     Suggested that the title be displayed if it contains
  282.           something.
  283. In addition, version 2.1 has the following improvements:
  284.     -     Error handling routines for printer not on, out of paper,
  285.           etc.
  286.     -     If first given name is not present, ________________ is
  287.           displayed.
  288.     -     Non printer problems are referred to author.
  289.  
  290.  
  291. Personal Ancestral File and PAF are registered trademarks of the
  292. Corporation of the President of The Church of Jesus Christ of
  293. Latter-Day Saints.
  294.  
  295. All rights to WS4PAF and its accompanying files are reserved. 
  296. WS4PAF may be distributed and used only in accordance with the
  297. provisions contained herein.  Comments, problem reports and
  298. suggestions for improvements are welcomed and may be sent to:
  299.  
  300. Address:       Frank E. Hutchison
  301.                Qtrs D, Mason Row
  302.                Yorktown, VA 23690
  303.  
  304. Phone:         (804)887-0290 between 6:00 and 9:00 pm Eastern
  305.  
  306. Anyone who first reports a problem or suggests an improvement will
  307. receive the first copy of the improved program free.
  308.  
  309. I also monitor the GENSOFT echo on the Fidonet for messages to
  310. Frank Hutchison.  Please note that I do not use my middle initial
  311. and that Hutchison is not HUTCHINSON.  Thank you.
  312.  
  313. REGISTRATION
  314. ------------
  315.      If you use Worksheet Generator for Personal Ancestral File
  316. (BA4PAF) you are asked to register with me.  The cost is FIVE
  317. dollars ($5.00).  This will (1) increase my high regard for you,
  318. (2) encourage me to improve the program, (3) allow me to inform you
  319. of improvements, (4) allow me to notify you in the event that a
  320. serious problem with WS4PAF is discovered, and (5) convince my wife
  321. that I'm not just playing with the computer.               ╔═════════════════════════════════════╗
  322.               ║                                     ║
  323.               ║         Worksheet Generator         ║
  324.               ║                for                  ║
  325.               ║       Personal Ancestral File       ║
  326.               ║               (PAF)                 ║
  327.               ║                 by                  ║
  328.               ║         Frank E. Hutchison          ║
  329.               ║                                     ║
  330.               ╚═════════════════════════════════════╝
  331.                                                     
  332.                        REGISTRATION FORM
  333.  
  334.  
  335. Surname: _____________________      Given1: _____________________
  336.  
  337. Given2: ______________________      Given3: _____________________
  338.  
  339. Address1: __________________________________________
  340.  
  341. Address2: __________________________________________
  342.  
  343. City:  _____________________________________________
  344.  
  345. State:  __________                  Zip Code: ________________
  346.  
  347. Phone: (_____) ________--_______________
  348.  
  349. How did you find out/acquire Worksheet Generator for Personal
  350. Ancestral File (WS4PAF)?
  351.  
  352. Comments/Suggestions/Problem Report:
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371. Mail to:            Frank E. Hutchison
  372.                     Qtrs D, Mason Row
  373.                     Yorktown, VA 23690
  374.